home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / pmlookupindomtext.z / pmlookupindomtext
Text File  |  1997-04-03  |  4KB  |  67 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMLLLLOOOOOOOOKKKKUUUUPPPPIIIINNNNDDDDOOOOMMMMTTTTEEEEXXXXTTTT((((3333))))                                      PPPPMMMMLLLLOOOOOOOOKKKKUUUUPPPPIIIINNNNDDDDOOOOMMMMTTTTEEEEXXXXTTTT((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmLLLLooooooookkkkuuuuppppIIIInnnnDDDDoooommmmTTTTeeeexxxxtttt - return text describing a performance metrics instance
  10.      domain
  11.  
  12. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////ppppmmmmaaaappppiiii....hhhh>>>>
  14.  
  15.      iiiinnnntttt ppppmmmmLLLLooooooookkkkuuuuppppIIIInnnnDDDDoooommmmTTTTeeeexxxxtttt((((ppppmmmmIIIInnnnDDDDoooommmm iiiinnnnddddoooommmm,,,, iiiinnnntttt lllleeeevvvveeeellll,,,, cccchhhhaaaarrrr ********bbbbuuuuffffffffeeeerrrr))))
  16.  
  17.      cccccccc ............ ----llllppppccccpppp
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      Provided the source of metrics from the current Performance Metrics
  21.      Application Programming Interface (PMAPI) context is a host, retrieve
  22.      descriptive text about the performance metrics instance domain identified
  23.      by _i_n_d_o_m.
  24.  
  25.      The value for the instance domain _i_n_d_o_m is typically extracted from a
  26.      _p_m_D_e_s_c structure, following a call to ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3) for a particular
  27.      performance metric.
  28.  
  29.      The argument _l_e_v_e_l should be PPPPMMMM____TTTTEEEEXXXXTTTT____OOOONNNNEEEELLLLIIIINNNNEEEE for a one-line summary, else
  30.      PPPPMMMM____TTTTEEEEXXXXTTTT____HHHHEEEELLLLPPPP for a more verbose description, suited to a help dialog.
  31.  
  32.      The space pointed to by _b_u_f_f_e_r will have been allocated in
  33.      ppppmmmmLLLLooooooookkkkuuuuppppIIIInnnnDDDDoooommmmTTTTeeeexxxxtttt with mmmmaaaalllllllloooocccc(3C), and it is the responsibility of the
  34.      caller to ffffrrrreeeeeeee(3C) the space when it is no longer required.
  35.  
  36.      ppppmmmmLLLLooooooookkkkuuuuppppIIIInnnnDDDDoooommmmTTTTeeeexxxxtttt returns zero on success.
  37.  
  38. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  39.      cccchhhhkkkkhhhheeeellllpppp(1), nnnneeeewwwwhhhheeeellllpppp(1), PPPPMMMMAAAAPPPPIIII(3), ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3) and ppppmmmmLLLLooooooookkkkuuuuppppTTTTeeeexxxxtttt(3).
  40.  
  41. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  42.      PPPPMMMM____EEEERRRRRRRR____NNNNOOOOTTTTHHHHOOOOSSSSTTTT
  43.           if the current PMAPI context is an archive log (help and one-line
  44.           text is not maintained in the archive logs)
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.